home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / prgtools / mint / mntdoc01.zoo / mintdoc / cat2 / fsymlink.nr < prev    next >
Encoding:
Text File  |  1993-03-03  |  1.5 KB  |  67 lines
  1.  
  2.  
  3.  
  4. Fsymlink(2)                Oct. 7, 1991               Fsymlink(2)
  5.  
  6.  
  7. N✓NA✓AM✓ME✓E
  8.        Fsymlink - create a symbolic link to a file
  9.  
  10. S✓SY✓YN✓NO✓OP✓PS✓SI✓IS✓S
  11.        LONG Fsymlink( char *oldname, char *newname );
  12.  
  13. D✓DE✓ES✓SC✓CR✓RI✓IP✓PT✓TI✓IO✓ON✓N
  14.        _✓F_✓s_✓y_✓m_✓l_✓i_✓n_✓k  creates  a new symbolic link (a "soft link") for
  15.        the file currently named _✓o_✓l_✓d_✓n_✓a_✓m_✓e.  If the _✓F_✓s_✓y_✓m_✓l_✓i_✓n_✓k call is
  16.        successful,  then  after the call the file may be referred
  17.        to by either name. A call to _✓F_✓d_✓e_✓l_✓e_✓t_✓e on the new name  will
  18.        not affect the existence of the file, just of the symbolic
  19.        link.  A a call to _✓F_✓d_✓e_✓l_✓e_✓t_✓e  with  the  name  _✓o_✓l_✓d_✓n_✓a_✓m_✓e  will
  20.        actually  delete the file, and future references with _✓n_✓e_✓w_✓-
  21.        _✓n_✓a_✓m_✓e will fail.
  22.  
  23.        Unlike hard links, symbolic  links  may  be  made  between
  24.        files on different devices or even different types of file
  25.        systems.
  26.  
  27. R✓RE✓ET✓TU✓UR✓RN✓NS✓S
  28.        0 on success
  29.  
  30.        EINVFN if the file system does not allow symbolic links
  31.  
  32.        An appropriate error code if the new symbolic link  cannot
  33.        be created.
  34.  
  35. S✓SE✓EE✓E A✓AL✓LS✓SO✓O
  36.        _✓F_✓l_✓i_✓n_✓k(2), _✓F_✓r_✓e_✓a_✓d_✓l_✓i_✓n_✓k(2), _✓F_✓r_✓e_✓n_✓a_✓m_✓e(2)
  37.  
  38. B✓BU✓UG✓GS✓S
  39.        No  check is made for the existence of the file named _✓o_✓l_✓d_✓-
  40.        _✓n_✓a_✓m_✓e; this could be construed as a feature.
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64. Version 0.9          MiNT Programmer's Manual                   1
  65.  
  66.  
  67.